Hello.
The files included in this archive (ziphive?) are intended to  instruct
the reader on the operation of the keyboard buffer in IBM compatible  &
ZDS computers.

File Name      Description
---------      -----------
readme.txt     This file.
stuffkb3.asm   Re-Edited version of Stuffkb2.asm. Contains information
               on the operation of the keyboard buffer & sample ASM &
               TC routines.
keyboard.C     Contains small routines regarding the keyboard buffer
               which I have found useful.
Please keep in mind that the author assumes no liability for the use of
any supplied information/software.

Regarding the files:
Regardless of  whether  or  not  you  intend  to  program  in  Assembly
language, you should be sure to examine the file STUFFKB3.ASM since  it
contains detailed information on the keyboard buffer. (The  information
is in the form of extensive comments.)
In case your wondering why I choose to supply the information inside an
assembly language listing, there is a reason. I had originally intended
to upload the .asm file without achievement in the hope  of  making  it
easier for you to read (either on or off line). Without  achievement,  I
could only upload one single file, hence my inclusion of virtually  all
the information in the .asm file.
You might also wonder why an .asm file was uploaded into the C library.
There are two reasons:
1) The original version was uploaded here (for reason's that escape  me
now).
2) The informative nature of the .asm file (most of its volume consists
of comments) combined with the included Turbo C sample calling  routine
seem to make it well suited for  this  library.  For  those  who  would
prefer not to program in ASM but rather C (or Basic, for  that  matter)
you should be able to easily extract enough information from  the  .asm
file to write your  own  similar  but  even  better  routines  in  your
favorite language.

"Extensively tested?": This information has  been  accumulated  largely
for the benefit of others. Aside for the keyboard clearing routine (which
I have found quite handy) I have not personally used or had  reason  to
use any of the keyboard buffer stuffing routines.  Do  extensively  test
any routines to make sure that they work satisfactorily for  you.  If
you find any problems do write!

Regarding feedback: If you discover any errors in these  files  or  can
add to the information contained within, feel free to drop me a note:
Richard Kanarek
Compuserve: 72371,111
GEnie:      R.KANAREK

"Avoiding problems/Misc. information":
-All .asm source code was written for compilation by  Turbo  Assembler*.
All .c source code was written for compilation by Turbo C*.  All  source
code should compile without errors or  warnings  unless  you  have  the
"Function should return a value" ANSI compatibility turned on (which I
doubt  most  people  would).  Compiling  source  code  with  MASM**  or
Microsoft/Quick/Whateveritscalled/C**  should  not   pose   a   serious
problem.
-Do remember to assemble the .asm file (after editing  it  as  needed!)
with TASM's /MX option enabled or proc's declared in the .asm file  and
extern'ed in your C program(s) might not be found @ link time.
-Do take head of my warning in the .asm file regarding writing your own
keyboard stuffing routines- They probably won't work the first time  you
try them and if they don't work they can turn ugly! Do save all work in
progress before testing you latest "debugged" software work of art!

Enjoy!



*=  Product of Borland International Inc.
**= Product of Microsoft Inc.



Richard Kanarek
7/17/1991